home *** CD-ROM | disk | FTP | other *** search
/ Aminet 3 / Aminet 3 - July 1994.iso / Aminet / util / misc / ClipWindow.lha / ClipWindow / ClipWindow.doc < prev    next >
Encoding:
Text File  |  1993-12-22  |  4.0 KB  |  81 lines
  1. ClipWindow
  2.  
  3. This program will help you manage the Amiga clipboard.  It's 
  4. purpose is to easily put common text contained in disk files 
  5. or icons onto the clipboard for pasting later.  ClipWindow was 
  6. created to fill a specific need: to automate the creation of 
  7. invoices using the BEST business accounting software.  It will 
  8. also be useful for many other tasks.  For example, inserting 
  9. "boilerplate" paragraphs into wordprocessor documents, and  
  10. programmers will find it useful for inserting common functions 
  11. or includes into their current project.  ClipWindow needs Amiga 
  12. Dos 2.0 or higher.  Source code is included, but to compile you 
  13. will need CBIO.C and CB.H from the Amiga ROM Kernel Reference 
  14. Manual - Devices, Third Edition section on the clipboard device.  
  15. Both of these files can be found on Fred Fisk disk 741 in the 
  16. RKRM_Devices archive.
  17.  
  18. Activating the ClipWindow icon opens an AppWindow on the 
  19. Workbench.  This may be resized and closed just as any other 
  20. window.  Text is fed to the program in one of two ways via 
  21. Project icons dropped on the AppWindow.  Simplest, is to put 
  22. the text you need clipboarded in the tooltype area of the 
  23. Project icon itself.  If you have a small amount of text, this 
  24. works well.  The second method is to use an editor to create 
  25. text in a disk file, then create a Project icon with the same 
  26. name.  ClipWindow will look for a disk file first, if none is 
  27. found it will try to use text from Tool Types.  Up to 8 
  28. kilobytes of text can be handled.
  29.  
  30. ClipWindow blanks out the clipboard when it is started.  If you 
  31. want to reset the clipboard later, you can drop a special Project 
  32. icon that has the word RESET as the default tool into the window.
  33.  
  34. There are several example Project icons included in this 
  35. distribution.  To try out ClipWindow, first open a Shell on the 
  36. Workbench, then activate the ClipWindow icon.  You will be 
  37. presented with an AppWindow.  Click once on the icon named 
  38. "ToolTypes", then use the Workbench Icons - Information menu 
  39. selection to examine the Tool Types contained within.  Next use 
  40. your mouse to drag the icon into the AppWindow and observe 
  41. ClipWindow echoing the text it finds.  Now click once in the 
  42. Shell window you opened previously and paste the clipboard 
  43. contents by typing right Amiga-V.  You should see text from the 
  44. icon flow at the cursor position.
  45.  
  46. Next drag the "RESET" icon into the AppWindow.  The clipboard will 
  47. be flushed of all contents. Try the paste operation again to verify.  
  48.  
  49. The icon labeled "TextFile" has an associated file containing simple 
  50. dialog.  Drop this icon into the AppWindow and observe ClipWindow 
  51. echoing the text.  This time the file name is displayed in reverse, 
  52. which indicates that data is coming from a file, not from the icon's 
  53. Tool Types.  Activate your Shell window and do the right Amiga-V 
  54. paste again to see the results.  
  55.  
  56. ClipWindow stacks text.  If you pull multiple text icons into the 
  57. AppWindow, all text will be pushed in order onto the clipboard.  You 
  58. can also do a multiple select and drop several Project icons in the 
  59. window at once.  
  60.  
  61. Carolyn Scheppner has graciously granted permission to include her 
  62. ConPaste Commodity in this distribution   Activate ConPaste by 
  63. clicking on it's icon, or by moving it into the WBStartup drawer on 
  64. your Workbench and rebooting.  Carolyn's program pastes the clipboard 
  65. contents in a very different way than Workbench.  She turns the 
  66. data into input events.  What this means to you is, you can paste 
  67. in a LOT more places.  The BEST business software for instance, opens 
  68. it's own custom screen which would not normally be accessible to the 
  69. Workbench paste routine.  ConPaste however, pastes perfectly.  Type 
  70. right Amiga - I to activate a ConPaste insert (this is configurable, 
  71. read Carolyn's doc file).  Thank you Carolyn for a program which 
  72. makes the Amiga clipboard 1000 times more useful.
  73.  
  74. ClipWindow is FreeWare.  If you find it useful, drop me a line 
  75. saying what you did with it.
  76.  
  77. Jim Harvey                                 jh25s56@sycom.mi.org
  78. 18538 Inkster
  79. Redford, Mich.
  80.  48240
  81.